home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / simcode.zip / SIMCODE.DOC < prev    next >
Text File  |  1992-11-06  |  31KB  |  682 lines
  1.  
  2.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  3.             SimCode Programming Language.
  4.            -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  5.  
  6.                [Version 6.0]
  7.  
  8.          Copyright  (c) 1992 By Michael Whitt
  9.          All Rights Reserved By Michael Whitt
  10.  
  11.  
  12.  
  13.   I, Michael Whitt hereby claim no responsibity for any damage caused by SimCode,
  14.  nor do I make any claims to the portablity of SimCode on any systems other than
  15.  complete 100% IBM compatibles.  SimCode is released as Shareware, and I believe
  16.  that you will like using and that you will want to register it.  I am offering
  17.  the complete documented and extra command version for only $5.00 for private
  18.  use.  For more details please read the end of this document for more info.
  19.  
  20. ////////////////////////////////////////////////////////////////////////////////
  21.  
  22.  First off:  Program updates may be found on the following Bulletin Boards.
  23.  
  24.  The Listening Post - VBBS 5.1 - 1-502-554-3082 - 300-14,400bps 24hours a day.
  25.  The HUG Board      - RBBS     - 1-502-554-0614 - 300-9600bps   24hours a day.
  26.  The PCC Board      - Wildcat  - 1-502-554-4201 - 300-2400bps   24hours a day.
  27.  
  28.  You may also call me by Voice at 1-(502)-856-3788 or you might even try leaving
  29.  a message for me at 1-(502)-658-3647 -<thats my beta testers number>-.  Or if
  30.  you dont want to call write me at:
  31.                     Michael Whitt
  32.                     Route 1 Box 81-d 
  33.                     Hickory, Ky. 42051
  34.  
  35.  Even if you dont wish to register SimCode, I would appreciate you just calling
  36.  or mailing me a postcard, Thanx a lot.
  37.  
  38. \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  39.         
  40.          |||||||||||||||||||||||||||||||||||||||||
  41.          | Introduction to Simple Code (SimCode) |
  42.          |||||||||||||||||||||||||||||||||||||||||
  43.  
  44.  For a very good while I was a SysOp of a fairly nice sized Bulletin Board, and 
  45.  I wrote tons of Doors Applications for my BBS.  I knew a lot of other SysOps 
  46.  that did not know a ounce of Programming and they always were asking me to do
  47.  small little programs for their BBS, such as Questionares and such, so I began
  48.  to think about writing a little script program for them to use, with this I 
  49.  began my work on SimText, which would come to be known as SimCode.
  50.  
  51.  The Original SimCode, or SimText as it was known would only center text and it
  52.  would change text colors, nothing real major huh?  Well luckly it evolved, and
  53.  contains over 100 commands.  SimCode now contains sound,color,file,and variable
  54.  commands. 
  55.  
  56. ================================================================================
  57. SimCode is no longer case sensitive like version .5 to 1.8, the case sensitivty
  58. was updated in version 2.  For those of you that already use a SimCode Version
  59. from 2 to 4, you may be interested in reading the next section only.
  60. ================================================================================
  61.  
  62.  
  63. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  64.  
  65.                   Major Updates from previous Versions.
  66.  
  67.  
  68. If you where using Versions 2 through 4, you may wish to read just this
  69. section of the document and note the major changes in SimCode with Version 6.0.
  70.  
  71.  
  72. Besides the addition of about ten more commands, and a new Con mode, undoubtably
  73. the most important change was a complete rewrite in the # and ^ commands.
  74.  
  75. With previous versions the # and ^ command where used to Write a line of text to
  76. the screen, as long as that line of text did not include more than 255 
  77. characters the # command would not only write the line to the screen but would
  78. also space down a line.  
  79.  
  80. The complete rewrite was done so that reqular text and ascii characters could be
  81. added to the entire screen.  To do this the # and ^ commands are no longer 
  82. limited to 255 characters, and they are only limited by your memory.  Also a 
  83. major change in these commands are that the # command is now exactly like the ^
  84. command.  If you wish to space down a line you must now just type a @ sign when
  85. ever you wish to space down a line.
  86.  
  87. Example: (with Version 2-4)
  88.  
  89. ~Red~
  90. #I am a SimCode Program# #Aint I nice?#
  91.  
  92. would display 
  93.  
  94. I am a SimCode Program
  95. Aint I nice?
  96.  
  97. Example (with Version 6.0)
  98.  
  99. ~Red~
  100. #I am a SimCode Program# @ #Aint I nice?#
  101.  
  102. would display
  103.  
  104. I am a SimCode Program 
  105. Aint I nice?
  106.  
  107. where-as the exact copy of the example from Version 2-4 would
  108. produce the following to the screen in Version 6.0:
  109.  
  110. I am a SimCode ProgramAint I nice?
  111.  
  112.  
  113. Now I think that you can see the diffrence.
  114.  
  115. The major reason for this changes was for the introduction of the Txt2Scs 
  116. Utility so that ANY text or ascii file can be used in Scripting.
  117.  
  118. ----------
  119.  
  120. Also a major update from Version 6.0 is the introduction of the File and 
  121. Printer commands ~OPEN ~, ~APPEND ~, and ~PRINT ~.
  122.  
  123. The Open command must be used before any Append command.  The Open command
  124. assigns a filename to write to, if the file already exist it just appends or
  125. adds on to it, else it creates the file. Example Use for Open given the file
  126. Names.Txt:
  127.          ~Open Names.Txt~
  128.  
  129. The Append command is the actually file writing command in SimCode, all info
  130. that it stores to a file is in ASCII Text, and can be read a numerous amount
  131. of ways, including coverting it into a SCS file with Txt2Scs. You MUST declare
  132. a file to open and append to using the Open command before the Append Command
  133. will work. Example Use for Append:
  134.  
  135. Example 1: Writing a string to the file:
  136.                                         ~Append <Hello World.>~
  137.  
  138. Example 2: Writing a variable-letter to the file:
  139.                         ~Append A~
  140.  
  141. The Print Command is a added utility that will send either text or variables
  142. to the printer.
  143.  
  144. Example 1: Writing a string to the file:
  145.                                         ~Print <Bye Bye.>~
  146.  
  147. Example 2: Writing a Variable-letter to the file:
  148.                         ~Print A~
  149.  
  150. ---------
  151.  
  152. Another Addition Change is in the Run command, you can now specify Paremeters
  153. to be passed to a Runned Program.
  154.  
  155. Example 1: ~RUN PKZIP.EXE : MyZip~
  156.  
  157. Example 2: ~RUN WIN.COM : /3~
  158.  
  159. Anything after the : comamnd is considered a Parameter.  a null parameter pass
  160. would be: ~Run Pkzip.exe : ~
  161.  
  162. ---------
  163.  
  164. A new Script Calling System has been added also the Call command will call 
  165. other Script files:
  166.  
  167. Example 1: ~CALL MyScript.Scs 1~
  168.  
  169.       The above will call MyScript.Scs and initize the starting color to blue~
  170.  
  171. Example 2: ~Call script.SCS  ~ 
  172.         
  173.       This would call Script and nullify the color to the original Red setting.
  174.  
  175. ----------
  176.  
  177. The Con mode was also added into SimCode, see below for more details.
  178.  
  179. --------------------------End of Update---------------------------------------- 
  180.          
  181. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  182.  
  183. Okay lets get started on your tour of SimCode...
  184.  
  185.  
  186. ********************************************************************************
  187.  
  188.  
  189. First lets list the Shareware SimCode Commands and their Functions:
  190.  
  191. These are not in any perticular order.
  192.  
  193.  
  194. ~Run filename : parameters~  =- This Command will Run external programs. 
  195.                 Example: ~Run Agame.Exe : CGA MOUSE~
  196.                 The Above would load the program Agame.exe
  197.                 and pass CGA and Mouse to it as Parameters.
  198.                 This is useful for linking SimCode and other
  199.                 EXE, COM, BAT, and script files together.
  200.             
  201. ~Call Script colornumber~    =- To call other SimCode Command Scripts, you
  202.                 would Type ~CALL MyScript.SCS colornumber~
  203.                 After the linked Script is finished, the
  204.                 linked SimCode will fall back to the Parent
  205.                 SimCode.  Note: A total of 25 Calls has can 
  206.                 Be used with 512k or ram.
  207.                 *Note, if you wish to load multiple Scripts
  208.                 you may wish to use the following parameters:
  209.                 ~Call Myscript colornumber~ the parameter 
  210.                 colornumber connvert the number it to a 
  211.                 ASCIIcolor. This is helpful when you are 
  212.                  running Text Files that are Converted into SCS
  213.                 withthe TXT2SCS program.  You dont have to pass 
  214.                 a Colornumber parameter, but I would advise it. 
  215.                        Example: 
  216.                  ~Call MySCS.SCS 3~ would load MySCS
  217.                 with the default color of 3.
  218.                                  
  219.  
  220. ~Get letter-variable~        =- This Command will store a string to memory.
  221.                 Example: ~Get A~ will store any user input
  222.                 up to 80 characters long into a Varible known
  223.                 as A.  You have up to 26 variables to use in
  224.                 the Shareware Version of SimCode.  They are
  225.                 A through Z.  See ~Use letter-variable~ 
  226.  
  227. ~Use letter-variable~        =- This Command will retrieve a string from memory.
  228.                 Example: ~Use A~ will retrieve any user input
  229.                 that was stored with the ~Get A~ command. Please
  230.                 note that all variables are Null at first.  You
  231.                 have up to 26 variables to retrieve. A to Z.
  232.  
  233. ~TIME~                       =- This Command will print to the user screen the
  234.                 current time in the following format:
  235.                 The Current Time is 12:00:00. 
  236.  
  237. ~DATE~                       =- This Command will print to the user screen the
  238.                 current date in the following format:
  239.                 The Cureent Date is 1/1/80.
  240.  
  241. ~MORE~                       =- Will display --Please press a key-- to the user
  242.                 screen and wait for the user to press a key then
  243.                 the program will continue.
  244.  
  245. ~ENTER~                      =- Will display --Please press ENTER-- to the user
  246.                 screen and wait for the user to press the enter
  247.                 key for the program to continue.
  248.  
  249. ~HALT~                       =- Causes Script program to stop on a dime.  Please
  250.                 note that in the Shareware Version of SimCode 
  251.                 the only real use for the ~Halt~ command is in
  252.                 the SimCode < Con mode.  In the SimCode < Con
  253.                 mode the ~Halt~ command will exit SimCode, also
  254.                 the ^Z or Control-Z command also acts as the 
  255.                 ~Halt~ command in the SimCode < Con Mode.
  256.                 See SimCode < Con Mode.
  257.  
  258. ~DOS~                        =- This command dos what it says, it will create a
  259.                 Dos shell.  Type Exit to return to SimCode. Also
  260.                 ~DOS~ reminds the user to type Exit to leave the
  261.                 shell.
  262.  
  263. ~RED~                        =- Changes Text Foreground Color to Red.
  264.  
  265. ~BLUE~                       =- Changes Text Foreground Color to Blue.
  266.  
  267. ~GREEN~                      =- Changes Text Foreground Color to Green.
  268.  
  269. ~WHITE~                      =- Changes Text Foreground Color to White.
  270.  
  271. ~BLACK~                      =- Changes Text Foreground Color to Black.
  272.  
  273. ~CYAN~                       =- Changes Text Foreground Color to Cyan.
  274.  
  275. ~YELLOW~                     =- Changes Text Foreground Color to Yellow.  
  276.  
  277. ~CLEAR~                      =- Clears all screen attributes.  Equal to CLS.
  278.                 This command can also be used with the ~BACK ~
  279.                 command and ~Bcolor ~ Commands.
  280.  
  281. ~SOUNDmhz,length~            =- This Command will play the selected MegaHertz 
  282.                 for the set length of time in milli-seconds.
  283.                 Example: ~Sound400,1000~ will play 400mhz for
  284.                 a total of 1000 milli-seconds or 1 second.
  285.  
  286. ~STAR~                       =- This command is a little extra command that
  287.                 plays a familar tune, thats all, try it out.
  288.  
  289. ~YN~                         =- Waits for Y/N Input, currently not used in the
  290.                 Shareware version of SimCode.
  291.  
  292. ~ASCIInumber~                =- Displays Ascii character for the Ascii number
  293.                 chosen. Example: ~ASCII1~ would display the
  294.                 Ascii character which is a Smiley Face. Try it
  295.                 out to completly understand the command.
  296.  
  297. ~XYxlocation,ylocation~      =- Moves the Text XY location for the current place
  298.                 to the specified XY location. Example: ~XY40,24~
  299.                 would move the cursor from whatever the current
  300.                 location is to column 40 on line 24. Useful in
  301.                 the # # and ^ ^ commands, as well as others.
  302.  
  303. ~BACK RED~                   =- Changes Text Background Color to Red.
  304.  
  305. ~BACK GREEN~                 =- Changes Text Background Color to Green.
  306.  
  307. ~BACK BLUE~                  =- Changes Text Background Color to Blue.
  308.  
  309. ~BACK YELLOW~                =- Changes Text Background Color to Yellow.
  310.  
  311. ~BACK BLACK~                 =- Changes Text Background Color to Black.
  312.  
  313. ~BACK WHITE~                 =- Changes Text Background Color to White.
  314.  
  315. ~BACK CYAN~                  =- Changes Text Background Color to Cyan.
  316.  
  317. *note on ~BACK ~ commands. If you wish to initalize the entire screen background
  318. to the ~BACK ~ color then you should use the ~CLEAR~ command after it, else only
  319. the screen attributes behind the current cursor location. Try it out and see.*
  320.  
  321. ~COLORnumber~                =- Changes Text Foreground Color to the selected
  322.                 number that fits its ASCII Color Number. 
  323.                 Examples: ~Color0~ : Black
  324.                       ~Color1~ : Blue
  325.                       ~Color14~ : Magenta
  326.  
  327. ~BCOLORnumber~               =- Changes Text Background Color to the selected
  328.                 number that fits its ASCII Color Number.
  329.                 Examples: ~Bcolor0~ : Black
  330.                       ~Bcolor1~ : Blue
  331.                       ~Bcolor14~ : Magenta
  332.  
  333. *note on ~BCOLOR ~ commands. If you wish to initalize the screen background
  334. to the ~BCOLOR ~ color then you should use the ~CLEAR~ command after it, else 
  335. only the screen attributes behind the current cursor location. Try it out & see.
  336.  
  337. ~CENTERnum <Text to Center>~ =- Centers a string of Text on the line number that
  338.                 is specified.  Example: ~CENTER12 <Hi>~ would
  339.                 center Hi on line number 12.
  340.  
  341. ~CENTERnum variable-letter~  =- Centers a variable-letter on the line number 
  342.                 that you specify. Example ~Center12 A~ would
  343.                 center any string that is contained in the 
  344.                 letter-variable A.  See ~GET ~ Command.
  345.  
  346. ~PAUSEnumber~                =- Pauses the program for set number of Milli-secs.
  347.                 Example: ~Pause1000~ would pause the program for
  348.                 1000 milli-seconds or 1 second.
  349.  
  350. ~OPEN filename~              =- This Command will Open or Create the filename 
  351.                 that is specified.  Example ~Open c:\Test.SCS~
  352.                 would Create the file C:\Test.SCS.  If the file
  353.                 already exist then it will be Appended.
  354.  
  355. ~APPEND <text>~              =- This Command will Append to the filename that is
  356.                 specified.  Example: ~Append <Hi>~ will Append
  357.                 or write Hi to the filename Opened with the 
  358.                 ~Open ~ Command.  Make sure you assign or Open
  359.                 before appending.
  360.  
  361. ~APPEND variable-letter~     =- This Command will Append to the Filename that is
  362.                 specified with the Open command.  An Example is:
  363.                 ~Append A~ would Append or Write the var-letter
  364.                 A to the file opened. 
  365.  
  366. ~PRINT <text>~               =- Same as the ~APPEND ~ command but sends output
  367.                 to Printer instead.
  368.  
  369. ~PRINT variable-letter~      =- Same as the ~APPEND ~ command but sends output
  370.                 to Printer instead.
  371.  
  372. # #
  373. # ^
  374. ^ ^
  375. ^ #                          =- These commands will write whatever is inbetween
  376.                 them. # HI # would write Hi to the user screen.
  377.  
  378. @                            =- Goes to the next line.
  379.  
  380. ................................................................................
  381.  
  382.  
  383.                   SimCode Modes
  384.  
  385. ................................................................................
  386.  
  387.  
  388. SimCode currently has two modes it has a Real mode and a Con mode.  The first
  389. mode that we will look at is the Con Mode.
  390.  
  391. The Con Mode is the mode in which SimCode goes into if no parameters are 
  392. passed to SimCode and the users types enter at the opening command of internal
  393. SimCode which is the Filname or Enter for Con Mode= prompt. 
  394.  
  395. There are Three ways to end the Con Mode, the Halt command, ^Z or ^C.  Any of
  396. these three commands will work, but the ~HALT~ command is the preferred. 
  397.  
  398. In Con mode, instead of SimCode looking into a file for commands, it will wait
  399. for the end user to manually type in the commands from the keyboard one line
  400. at a time.  In the Con Mode there are few commands that will not work right,
  401. see Appendix D - "CON MODE ERRORS AND PROBLEMS".
  402.  
  403. The Con mode is perfect for someone that is new to SimCode to learn how to 
  404. program in SimCode. Most all of the basic commands will work just as they 
  405. would in the Real mode.  The added advantage of the Con Mode is to check out
  406. a command to see if it will do what you want it to do.  It is also helpful 
  407. because you can load your editor and another copy of Simcode from within it
  408. with the ~RUN ~ and ~DOS~ commands. 
  409.  
  410. I suggest that you print out a copy of your SimCode.DOC and practice each 
  411. command from the Doc in the Con Mode.
  412.  
  413. ()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()()
  414.  
  415.             The SimCode Real Mode.
  416.             ----------------------
  417.  
  418. In real mode, SimCode looks for a filename (Script) to run.  Scripts may be
  419. created with any Pure Ascii Editor, or the Copy Con command at Dos.  The 
  420. default Extension for a SimCode Command Script is SCS, and if you type:
  421. SIMCODE THISISIT at the command prompt in dos, SimCode will automatically add
  422. the Extension .SCS.  If for some reason you do not want the SCS extension or
  423. you dont wish to have a extension at all, that is okay, just remeber that if
  424. you do not have a extension to type a . behind the filename or the Interpeter
  425. will think that it is looking for a SCS file extension by the Filename.  
  426. Example: Say you have three programs as such: SIMTEST.SCS, SIMTEST.TST and the
  427. file SIMTEST. you would type the following to run each example:
  428.  
  429. SIMTEST.SCS    type <SIMCODE SIMTEST or SIMCODE SIMTEST.SCS> at the prompt.
  430. SIMTEST.TST    type <SIMCODE SIMTEST.TST> at the prompt.
  431. SIMTEST.       type <SIMCODE SIMTEST.> at the prompt.
  432.  
  433. In the Real mode, a Script will end in one of a few ways:
  434.   1) End of File  --- No more commands to run.
  435.   2) ~HALT~ command --- Controlled Stop.
  436.   3) RUNTIME error --- Missing Script file.
  437.  
  438.   Of the above, Number 1 is probley the best way to end a Script, since in the
  439.   Shareware version of SimCode, there is no looping, a ~HALT~ command is only
  440.   a waste of space, since there is no nesting.
  441.  
  442.   Also in reference to Number 3, it is not likely that you will get a RunTime
  443.   error, but it is still possible under the right conditions.
  444.  
  445. You may convert any Pure Ascii Text files, into Simcode Command Scripts at any
  446. time from dos by using the TXT2SCS.EXE program included with SimCode.  An good
  447. example would be if you had a DOC file to distrubite with your software, but
  448. also wanted a self pausing Script to go with it you would take that filename
  449. let's say AGAME.DOC and convert it into a Script by typing 
  450.              TXT2SCS AGAME.DOC AGAME.SCS
  451.  
  452.  
  453.  
  454. )))))))))))))))))))))))))))))))))))))))(((((((((((((((((((((((((((((((((((((((((
  455.  
  456.                      ============================
  457.                      =The SimCode Command Script= 
  458.                      ============================
  459.  
  460.  
  461.  The SimCode Command Script or (SCS) is the core of the SimCode Programming 
  462. language.  SimCode reads from Commands Scripts and converts them into actions.
  463.  
  464. For example one of the smallest possible SimCode Scripts would be:
  465.  
  466. ┌─────────────────────────────────────────────────────────────────────────────┐
  467. │~Red~                                                                        │
  468. │~Back Black~                                                                 │
  469. │~Clear~                                                                      │
  470. │# Hello                                                                      │
  471. │      Welcome to the world of SimCode.                                       │
  472. │                                      The Easiest Programming Language       │
  473. │                                                                      ever!! │
  474. │                                                                            #│
  475. │~Xy29,24~                                                                    │
  476. │~More~                                                                       │
  477. └─────────────────────────────────────────────────────────────────────────────┘
  478.  
  479. The Above would Change the Text Foreground Color to Red, then the background
  480. would be changed to Black, and the Screen Cleared.  After the Screen is cleared
  481. SimCode will Display the line Hello Welcome to the World... Just like it is in
  482. the above box, then the cursor would goto line 24 column 29 and wait for a key
  483. to be pressed.
  484.  
  485. To call another Script Called MYscript.SCS you would do the following comamnd.
  486.  
  487. ┌──────────────────────┐
  488. │~CALL Myscript.SCS 10~│
  489. └──────────────────────┘
  490.  
  491. The above would call Myscript.scs and run it then return control to the parent
  492. Script.
  493.  
  494. And Example would be the following:
  495.  
  496. ┌─────────────────────────────────────────────────────────────────────────────┐
  497. │                            Script1.scs                                      │
  498. │~Red~                     Set Foreground Color to Red.                       │
  499. │     ~Back Black~         Set Background Color to Black.                     │
  500. │                 ~Clear~  Clear the Screen.                                  │
  501. │                                                                             │
  502. │#Welcome to SimCode# @@@  Write Welcome to SimCode then space down 3 lines.  │
  503. │                                                                             │
  504. │#Calling Script2#      Write Calling Script2 to screen.                      │
  505. │@@@                    Space down Three Lines.                               │
  506. │~ENTER~                Wait for enter key to be pressed.                     │
  507. │~Call Script2.SCS 11~  Load Script2.scs with color 11.                       │
  508. │                                                                             │
  509. │~Color12~   Change Foreground Color to Light Red.                            │
  510. │~Clear~    Clear Screen.                                                     │
  511. │#bye bye#@ Write bye bye to screen.                                          │
  512. │~xy29,24~ Goto Line 24 Column 29.                                            │
  513. │~Bcolor1~ Change Back Ground Color to Blue.                                  │
  514. │~More~   Wait for user to press a key.                                       │
  515. └─────────────────────────────────────────────────────────────────────────────┘
  516.  
  517. ┌─────────────────────────────────────────────────────────────────────────────┐
  518. │                           Script2.scs                                       │
  519. │                                                                             │
  520. │~Green~                     Set Color to Green.                              │
  521. │~Center12 <I am Script2>~   Center I am Script2 on line 12.                  │
  522. │~Pause2000~                 Pause for 2 seconds.                             │
  523. └─────────────────────────────────────────────────────────────────────────────┘
  524.  
  525. The above describes what it is doing inside the Script.  Anything out side of
  526. the ~ # ^ or @ commands is comments.
  527.  
  528. An Example of the ~GET ~, ~USE ~, ~PRINT ~ and ~APPEND ~ commands:
  529.  
  530. ┌─────────────────────────────────────────────────────────────────────────────┐
  531. │#What is your Name # ~GET A~  Prompt for user name, then store to A.         │
  532. │@                                                                            │
  533. │#What is your Age # ~GET B~  Prompt for user age, then store to B.           │
  534. │@                                                                            │
  535. │#What is your City # ~GET Z~ Prompt for user city, then store to Z.          │
  536. │@                                                                            │
  537. │@                                                                            │
  538. │~GREEN~                                                                      │
  539. │#Your name is # ~USE A~  Display your name is and return A.                  │
  540. │@                                                                            │
  541. │#Your age is # ~USE B~  Display your age is and return B.                    │
  542. │@                                                                            │
  543. │#Your City is # ~USE Z~ Display your city is and return Z.                   │
  544. │@                                                                            │
  545. │@                                                                            │
  546. │@                                                                            │
  547. │~OPEN DATABASE.DAT~                                                          │
  548. │~APPEND A~                                                                   │
  549. │~APPEND B~                                                                   │
  550. │~APPEND Z~                                                                   │
  551. │~PRINT A~ ~PRINT B~ ~PRINT Z~                                                │
  552. └─────────────────────────────────────────────────────────────────────────────┘
  553.  
  554. The above program is an example of the Variable, File and Printer Commands.
  555.  
  556. The Program will prompt the user for his name, age, and city, store the user's
  557. input into A,B,and Z.  Then will Re-Display the Users Answers, and then it will
  558. Open up DATABASE.DAT and APPEND A,B,and Z answers to DATABASE.DAT.  If DATABASE
  559. file does not exist it will create it, else it will just append to the end of
  560. the file.  The Last line will print the answers to the Printer.
  561.  
  562. At the time of this document, using the ~PRINT ~ command without a printer 
  563. online would result in a runtime error.  Hopefully this problem was fixed. You
  564. may wish to look into the Last.Add file to see if there is any updates on the
  565. ~PRINT ~ command.
  566.  
  567. Examples of the ~SOUND ~, ~STAR~, ~PAUSE ~, ~TIME~, ~DATE~, and ~DOS~ commands:
  568.  
  569. ┌─────────────────────────────────────────────────────────────────────────────┐
  570. │~SOUND500,1000~ Sound 500mhz for 1 second.                                   │
  571. │~Pause 2000~ Pause for 2 seconds.                                            │
  572. │~TIME~ @ Display current Time.                                               │
  573. │~DATE~ @ Display Currnet date.                                               │
  574. │~Star~ Plays theme song for a certain movie.                                 │
  575. │~DOS~ Shell to dos until user types EXIT.                                    │
  576. │~ENTER~                                                                      │
  577. └─────────────────────────────────────────────────────────────────────────────┘
  578.  
  579. The Below is an Example of the Ascii to Screen Command.
  580.  
  581. ┌─────────────────────────────────────────────────────────────────────────────┐
  582. │~Ascii1~ Display ascii character 1 # This is a example of the Ascii Command #│
  583. │~Ascii2~ Display ascii character 2                                           │
  584. └─────────────────────────────────────────────────────────────────────────────┘
  585.  
  586. [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]
  587.  
  588.  
  589.                      But what can I use SimCode for?
  590.              -------------------------------
  591.  
  592.  Well first off as I stated earlier, you can Use SimCode BBS Doors, but a more
  593. broad use for SimCode could be either teaching, fun, or SimCode could also be
  594. used as a Installation program, or a Program introduction.  For an example, I
  595. have a game called No-Nuke that is released as shareware, I used SimCode as a
  596. Introduction Document Script to No-Nuke.  I also have used it for this program
  597. too.  Bye running Install.Bat you was also running SimCode.SCS.  The use of 
  598. SimCode is up to you.
  599.  
  600. ]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]][[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[
  601.  
  602.  
  603.  
  604.                        License Agreement for SysOps.
  605.                        -----------------------------
  606.  
  607. Attention SysOps: If you wish to use SimCode for your Doors or as a Ad. file,
  608.                   you MUST send me $10.00 and you must send me a written letter
  609.           explaining exactly what your Script does.  If you dont send
  610.           me the $10.00 I will not hire a hit man to track you down, but
  611.                   may God be easy on your soul.  I am also asking that you add
  612.           The following line somewhere into your Script or Doc file.
  613.                   Portions (c) Copyright 1992 Michael Whitt, SimCode Scripter.
  614.                   
  615.             
  616.                      License Agreement for Programmers.
  617.                      ----------------------------------
  618.  
  619. Attention Programmers: If you wish to use SimCode with ANY of your Releases, you
  620.                       MUST, send me $15.00 and you Must send me a written letter
  621.                       explaining exactly what your Script does.  I am not as 
  622.               nice to Programmers that dont register their copy as I am
  623.               to SysOps.  You also must include the following line in 
  624.                       your script or Doc file:
  625.                      Portions (c) Copyright 1992 Michal Whitt, SimCode Scripter.
  626.  
  627.  
  628.  
  629.                      License Agreement for Private Use.
  630.                      ----------------------------------
  631.  Hey as long as it is not public I dont care what you use SimCode for, but if 
  632. SimCode is released with a script, you must register SimCode for $5.00.
  633.  
  634.  
  635. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  636.  
  637.  
  638.  
  639.         For Additional Script help, please call me at (502)856-3788.
  640.  
  641.  
  642. ===============================================================================
  643.  
  644.  
  645. Other Programs by the Author of SimCode:
  646.  
  647.   No-Nuke - Action game, can you save three cities before the warheads strike?
  648.             EGA/VGA mouse driven game.
  649.  
  650.   Cryptic Thoughts - Nice little File Encoder/Decoder.
  651.  
  652.   Madlibs - Cool word game with a twist.
  653.  
  654.   AutoMess - Automatic Messager for Searchlight BBS.
  655.  
  656.   Slusage - Usage Chart for Searchlight BBS.
  657.  
  658.  
  659. ================================================================================
  660.  
  661.  
  662. SimCode Version 6.0 was wrote and compiled in Turbo Pascal 6.0.  Plans for 7.0
  663. are being made in Mix's Power C.  Projected Release of 7.0 is Feburary 28th '93.
  664.  
  665.  
  666. ================================================================================
  667.  
  668.  
  669. SimCode.Arj should include the following files:
  670.  
  671.  SimCode.Doc - This file.
  672.  SimCode.Exe - SimCode Script Compiler
  673.  SimCode.SCS - Introduction Script.
  674.  ExaScs1.Scs - Script
  675.  ExaScs2.Scs - Script
  676.  ExaScs1.Scs - Script
  677.  Txt2Scs.Exe - Text to Script Conversion utility.
  678.  Txt2Scs.Doc - Doc file to Txt2Scs.
  679.  Script1.Scs - Script
  680.  Script2.Scs - Script
  681.  Sota.Gif    - Gif of Author and his fiancee'
  682.  SimCod2.Scs - Linked Script